Run the program, drag a folder from the Finder to the window, type in the word you want to find and press Return to start searching. Command-Period aborts the search.
ﾊ
The list of files that contain the word you entered will be shown progressively as the search continues. Double-click the filename to view the file. The found word is shown in context in the list.
Double-click the line to view the file in a text window. Here you can find the word you searched for, or other words in this window.
You can save a document with the find string and a start folder in a document to use again in the future. I recommend saving documents with useful start folders.
Details
I wrote this little app primarily for speed, but it uses asynchronous file reads and the Thread Manager so it is kind to other apps and runs smoothly in the background. By default it only searches in files of type 'TEXT' and only in the first 2Mb of the file (although the entire file will be viewed if there is enough memory).
TurboFind first looks at the file name to see if that matches what you are looking for, if the search content option is on in the preferences, TurboFind looks in the data of the file for the string you are searching for.
The search will cover all files inside the start folder you drag in to window and shown the "Inﾉ" field and will recurse down through all subfolders in it.
You can also launch TurboFind by dragging a folder or disk to the program icon to set the search place.
Once a line in the found list is selected (either by clicking, or with the down/up arrow keys), pressing the Enter key will view the file.
You can use menus or key equivalents to: reveal the selected file in the Finder, get Info in the Finder, or ﾒRunﾓ the file in the Finder (equivalent to double-clicking it).
When you start searching TurboFind will try to count all the files in the folder hierarchy you gave so that it can give you a progress thermometer. (If this takes more than 10 seconds, it just starts searching with the ﾒbarber poleﾓ pattern.)
Advanced searching
If you enter more than one word in the find field, separated by spaces, then only those files that contain all of the words will be included in the hit list.
If you use regular expressions, they have their own way of doing this ANDing, refer to documentation on regular expressions for info on this.
If ﾒShow all matchesﾓ is off then files with all words anywhere in them will be included in the hit list.
If ﾒShow all matchesﾓ is on only files with all words on the same line will have that line included in the hit list.
Iﾕm sorry if this seems confusing, but in practice, it seems to be the way I, at least expect it to work.
Preferences
ﾊ
If ﾒSearch file contentﾓ is on, TurboFind looks in the file data.
If ﾒFast modeﾓ is on TurboFind is unkind to other applications.
If ﾒSearch all file typesﾓ is off, only TEXT files are searched (the default).
If ﾒCase sensitiveﾓ is on, only matches with the same capitalisation are found.
ﾒRegular expressionsﾓ are a powerful way to describe text match patterns.
You can choose how many thousand characters of a file (k) to search.
If ﾒSort the hit listﾓ sorts the list of matching filenames alphabetically.
ﾒShow all matchesﾓ will show each line of the file that contains a match.
You can view in TurboFind, with XTND to show styles, if available, or
You can choose an external application to be asked to view the document.
Files can be saved from the text view window and you can choose the creator.
Note that if you ﾒfeel the need for speedﾓ, search without regular expressions and with show all matches off and the list of matching files will come up most quickly.
There is balloon help on the items in the preferences dialog.
Licensing
TurboFind is ｩ 1996 Peter Marks, if you find that you use it more than 20 times a US$10 shareware fee is required.
When you register, Iﾕll email you the PowerPC native version, which is really fast!
Here is the pricing schedule:
Each single user license is US$10 per user. (Cheap considering the time it saves you!)
A site license costs US$500, and covers all users for your organisation within a 160 kilometre radius of your site (100 miles). One big advantage of a Site License is that you donﾕt need to keep track of how many people at your site are using the software.
A World-Wide License costs US$2000 and it covers all locations for your organisation on the planet earth.
Paying is easy!
Paying for TurboFind is simple. You can register via the web at:
<http://kagi.direct.net/cgi-bin/register1.cgi?VZ>
(If you have Internet Config 1.2 or later you can click on the URL in the TurboFind about box). Or...
Open the Register program that accompanies TurboFind. Enter your name, your email address, and the number of single user licenses you desire to purchase (or Site or World-Wide licenses). Save or Copy or Pint the data from the Register program and send the data and payment to Kagi. Kagi handles my payment processing.
If paying with Credit Card or First Virtual, you can email or fax the data to Kagi. Their email address is sales@kagi.com and their fax is +1 510 652-6589. You can either Copy the data from Register and paste into the body of an email message or you can Save the data to a file and attach the file to an email message. There is no need to compress the data, itﾕs already pretty small. If you have a fax modem, just Print the data to the Kagi fax number.
Payments sent via email are processed within 3 to 4 days. You will receive an email acknowledgement when it is processed. Payments sent via fax take up to 10 days and if you provide a correct internet email address you will receive an email acknowledgement.
Copyrights
TurboFind is ｩ 1996-1997 by Peter Marks.
Regular expression library ｩ 1986 by University of Toronto. As altered by John Gilmore, James A. Woods, and Thomas R. Kimpton,
WASTE Text engine ｩ 1993-1995 Marco Piovanelli, used the wrapper class by ｩ1995 Hiroshi Lockheimer and Timothy Paustian.
LBalloonTracker is ｩ 1996 Corporate Software & Technologies Int. Inc. (CS&T)
Limitations
Peter Marks accepts no responsibility for any damage done by this software.
Thanks
Mark Nagata for professional bug reporting and feature suggestions.
Pete Gontier for MoreFinderEvents. (A living international treasure).
Jim Luther for MoreFiles. (So great it should be in the toolbox!).
Metrowerks and Greg Dow for CodeWarrior and PowerPlant.
Marco Piovanelli for the WASTE text edit engine.
Hiroshi Lockheimer and Timothy Paustian for the wrapper class for PowerPlant.
Struan Robertson and Allan Bell for feedback and support.
Kagi for having thought things out so well.
Peter N Lewis for the Register application, Internet Config, and feedback.
LBalloonTracker is ｩ 1996 Corporate Software & Technologies Int. Inc. (CS&T).
Markus Gail for improving the icons and letting me ship them.
What users have said
Don Crabb
ﾒTurboFind 2.0 is cool. TurboFind is way useful. And TurboFind is really, really fast.ﾓ
Mark, a Japanese userﾉ
ﾒIt works great, both on my IIci running System J1-7.1 and on my PB5300ce running System J1-7.5.5. The filenames are beautifully displayed with Osaka 9pt font.ﾓ
Garyﾉ
ﾒWow, it is really great. You should ask for a penny for each minute it saves the users. You would be rich real soon. Thanks for a really great tool.ﾓ
Fredericoﾉ
"You did it again! Congratulations and thanks for your useful TurboFind. "
Farhadﾉ
"TurboFind is cool. Something to replace XXXXX with. The drag into the window is nice..."
Tomﾉ
"Turbofind works well -- good job."
Jeanﾉ
"1) well done."
Collections which have been given permission to include TurboFind: MacAddict, MacWorld (Polish edition), Mac Fan (Japan),
History
2.0 Released as ShareWare.
2.1 Threaded version released.
Regular Expression Syntax
If the regular expression option is checked in the preferences, then the filename, and then (if search content is on), each line of the content of each file is searched for a match with the regular expression you entered.
Regular expression are a rather obscure, but very powerful way of expressing a string of text you wish to find. The notes here are for experienced users, if you havenﾕt used this stuff before I suggest you look for a tutorial in a unix book on grep.
This is reproduced from the class posted by Thomas R. Kimpton to the Metrowerks PowerPlant archive (Thanks Thomas!).
A regular expression is zero or more branches, separated by '|'.
It matches anything that matches one of the branches.
A branch is zero or more pieces, concatenated.
It matches a match for the first, followed by a match for the second, etc.
A piece is an atom possibly followed by '*', '+', or '?'.
An atom followed by '*' matches a sequence of 0 or more matches of the atom.
An atom followed by '+' matches a sequence of 1 or more matches of the atom.
An atom followed by '?' matches a match of the atom, or the null string.
An atom is a regular expression in parentheses (matching a match for the
regular expression), a range (see below), '.' (matching any single character), '^' (matching the null string at the beginning of the input string), '$' (matching the null string at the end of the input string), a '¥' followed by a single character (matching that character), or a single character with no other significance (matching that character).
A range is a sequence of characters enclosed in '[]'.
It normally matches any single character from the sequence.
If the sequence begins with '^', it matches any single character not from the rest of the sequence. If two characters in the sequence are separated by '-', this is shorthand for the full list of ASCII characters between them
(e.g. '[0-9]' matches any decimal digit).
To include a literal ']' in the sequence, make it the first character (following a possible '^'). To include a literal '-', make it the first or last character.
Notes
･ If you double-click on a binary file of some kind that canﾕt be viewed with XTND (or if itﾕs off) it can take a long time for the view window to open.
･ If the use XTND checkbox is dimmed on a PowerPC it might be because you donﾕt have the ﾒXTND Power Enablerﾓ extension installed.
